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Introduction 

This memo constitutes a preliminary work plan for Common Software development for 
2Q77 through 2Q79. Common Software is application software that is utilized by several 
application areas and is centralized to ensure consistency and efficient coupling with Pilot 
and to reduce redundancy. 

This activity area is concerned principally with user interface facilities, data management 
facilities, and other utility packages. 



Summary of Projects 

This work plan covers the following projects: 

o Specification of the user interface for the Diamond prototype system. This may at times 
include assistance in implementing the specified user interface. ^' 

° Assist in the specification of the user interface for Janus/OIS. 

o Specification and development of user interface software facilities for the Janus/OIS 
Workstation. 

o Specification and development of djta management,. software facilities for Janus/OIS, 
including the implementation of some standard data types. 

o Specification and development of other commonly used software packages, such as 
storage allocators, as the need arises. 

o Specification and development of user training materials and techniques for all tests 
sponsored by SDD for Janus/OIS. This includes any software needed to support on-line 
help aids. 

These projects are discussed in more depth in the following sections. 
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User Interface 

One of the most important aspects of Janus/OIS is its user interface. It is vital to the 
success of Janus/OiS that the user perceive it as a coherent system. This means that the 
user must be able to apply learning experiences in one application environment to others. 
He must be able to predict system behavior based on past experience. To this end» a 
centralized set of user interface facilities will be constructed. The work that is to be done 
in this area consists of the following: 

o Collaborate with the application designers and others with expertise in user interface 
design to help specify user interfaces for the applications, ensuring consistency among 
them. A principal goal is to achieve system coherence. 

o Specify user interfaces for the Diamond prototype system. This includes specification 
of the Early Bird user interface, in collaboration with the Applications Software Group. 

o Design and implement a set of software facilities to be used by the applications in 
implementing the specified user interfaces. Included is a software interface to the display 
and user input devices. 

o Monitor feedback on the user interface software facilities and improve and maintain 
them as needed. 

o Implement a help facility for users, supplying the data base on which it is based. This 
may be subsequently modified by OSD training personnel. 

o Train the users during all tests sponsored by SDD (see test schedule below). 

o Work with the Functional Test Group and the OSD Human Factors group to define 
user tests to determine user's ability to grasp concepts and presentations. In some cases, 
write the code to support these tests. In some cases, it may be necessary to conduct our 
own tests if some critical decision depends on the test results. 



Data Management 

The data management facilites allow separately developed applications to share data objects 
within the Janus/OIS file system. Given the expected longevity of the OIS, it is vital that 
this area be given much attention -- data objects must be handled in a general enough 
framework to allow for inevitable changes during the lifetime of Janus/OIS. It must allow 
for different implementations of objects, based on their size, storage medium, and so 
forth. It must allow applications that are built by separate people at different points in 
time to share objects in such a way that the object implementation could change in some 
ways without causing source changes in the using applications. 

The software facilities to be provided offer interfaces and implementations for directories 
(map user actions into Pilot file identifiers), documents, printable forms of documents, 
streams (a sequential access mechanism), and so forth. 

The interested reader is referred to section 4.4 of the Pilot; OIS Control Program: 
Concepts and Facilities document. 
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other Software packages 

The Common Software activity will also produce other common application packages as 
desired. Examples include general storage allocation packages and perhaps common error 
handling procedures. These packages will be negotiated with applications groups as needed. 



Strategy Summary 

The user interface and data management activities will have as an ultimate focus Janus 
executing on DO. Much of the software will be developed and tested within the Diamond 
Alto context during 1977, however. Diamond provides an existing framework that is a 
prototype of the Janus system (a version of Diamond will be used for Early Bird) and 
allows an early implementation of the facilities. In the course of this Alto implementation, 
internal specifications will be produced. Toward the end of 1977 the Janus-1 functional 
specification will have been produced and the ideas that were implemented and used within 
Diamond will have been shaken down to the extent that accurate user interface and data 
management software functional specifications can be produced and a DO implementation 
can be derived from the running Alto software. 

It is assumed that the first quarter of 1978 will be used for recoding some of the software 
developed within Diamond and integrating Diamond with an initial release of Pilot on 
DO. Pieces of Pilot will be developed during 1977 within the Mesa runtime context and on 
stand-alone DO's/Dl's. Pilot Functional Specs are assumed to be firm by 9/77. After this 
integration has been accomplished, the resulting system will serve as the basis for Janus-1 
and the prototype for Janus-2. 

In addition to developing user interface software, a major portion of the user interface 
activity is focused on collaborating with the Applications Software Group and the 
Prototype Software Group to produce the specifications of the Janus and Diamond user 
interfaces, respectively. As part of this activity, a number of user tests will be devised and 
conducted in conjunction with Functional Test and OSD Human Factors. In the course of 
these tests, it will be necessary to construct certain software games and mock-ups to be used 
by the subjects. 

A training package will be produced for the Early Bird test and will be subsequently 
improved for the later Blue Ribbon, Operator Acceptance Test, Alpha, and Beta test. This 
will be done for both Janus-1 and Janus-2. An on-line help facility will be part of both 
products to allow for self training after initial training. 
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Major Milestones 



Legend: 



A => Ayers, B => Burr, I => Irby, K => Kimball, M => McJones. 
N => Nev/lin, P => Peter Bishop, R => Richard Moore, S => Smith, 
PSG => Prototype Softv;are Group, ASG => Applications Softv/are Group, 
Prototype-2 => Prototype for Janus-2 on DO, S/W => Software. 



JANUS-1 

Diamond 
Janus-1 
Diamond 
Janus-1 
Diamond 
Diamond 
Janus-1 
Janus-1 
Diamond 
Janus-1 
Janus-1 
Janus-1 
Janus-1 

JANUS-2 



(for Early Bird) User Interface Specified 

Directories and Streams Specified (prelim. Rel.) 

UI Softv/are Facilities Specified 

User Interface Specified {with ASG} (prelim. Rel.) 

(for Early Bird) S/W Designed {with PSG, ASG} 

Data Mgmt. S/W. Std. Objs. Specified 

UI Software Facilities Specified (prelim. Rel.) 

Data Mgmt. S/W, Std. Objs. Specified (prelim. Rel.) 

Implemented for Early Bird {with PSG, ASG} 

UI Software Facilities Specified (prog. Rel.) 

Data Mgmt. S/W, Std. Objs. Specified (prog. Rel.) 

UI Software Facilities Released on DO 

Data Mgmt. S/W, Std. Objs. Released. on DO 



4/77 


ISKNB 


4/77 


lAM 


6/77 


lARN 


6/77 


ISKB 


6/77 
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7/77 


lAMPR 


9/77 


lARN 


9/77 


lAMPR 


10/77 


lARN 


12/77 


lARN 


12/77 


lAMPR 


3/78 


lARN 


3/78 


IMPR 



Prototype-2 User Interface Specified 
Prototype-2 UI Software Facilities Update 
Janus-2 User Interface Specified {with ASG} (prelim. Rel.) 
Prctotype-2 Software Designed {with PSG, ASG} 
Prototype-2 Data Mgmt. S/W, Std. Objs. Update 
Janus-2 UI Software Facilities Update (prelim. Rel.) 
Janus-2 Data Mgmt. S/W, Std. Objs. Update (prelim. Rel.) 
Prototype for Janus-2 Implemented {with PSG, ASG} 
Janus-2 UI Software Facilities Update (prog. Rel.) 
Janus-2 Data Mgmt. S/W, Std. Objs. Update (prog. Rel.) 
Janus-2 User Interface S/V/ Released on DO 
Janus-2 Data Mgmt. S/W, Std. Objs. Released on DO 
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9/77 
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lARN 
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Janus Test Schedule 



Janus-1 Early Bird: 

Janus-1 Blue Ribbon Panel Test: 

Janus-2 Early Bird: 

Janus-1 Alpha Test: 

Janus-1 Operator Acceptance Test: 

Janus-1 Beta Test: 

Janus-2 Blue Ribbon Panel Test: 

Janus-3 Early Bird: 

Janus-2 Alpha Test: 

Janus-2 Operator Acceptance Test: 

Janus-2 Beta Test: 

Janus-3 Blue Ribbon Panel Test: 

Janus-3 Alpha Test: 

Janus-3 Operator Acceptance Test: 

Janus-3 Beta Test: 



10/77 (Palo Alto), 12/77 (Dallas) {Duration: one year} 

9/78 {Duration: a few months} 

10/78 (Palo Alto), 12/78 (Dallas) {Duration: one year} 

1/79 {Duration: 3 months} 

3/79 {Duration: Merges with Field Test until 10/79?} 

4/79 {Duration: 6 months} 

9/79 {Duration: a few months} 

10/79 (Palo Alto), 12/79 (Dallas) {Duration: one year} 

1/80 {Duration: 3 months} 

3/80 {Duration: Merges with Field Test until 10/80?} 

4/80 {Duration: 6 months} 

9/80 {Duration: a few months} 

1/81 {Duration: 3 months} 

3/81 {Duration: Merges with Field Test until 10/81?} 

4/81 {Duration: 6 months} 



Schedules 



Legend: 



I = Internal Spec for Prototype 

P = Functional Spec — Preliminary Release 

F = Functional Spec — Programming Release 

R = Initial Release 

U = Updated Release 

D = Design 

d = Dl/0 processor required (subsequent releases are on these 

processors) 
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Critical Milestones 

Timely completion of user interface specifications for Diamond (for Early Bird) and Janus 
is necessary for subsequent product development. A release of Pilot on DO no later than 
3/78 is assumed. User tests are needed to test hypotheses about user concepts. 
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M anpower (people) 



1977 



1978 



1979 



Prototype User Interface (ISKBM) 
Janus User Interface (ISKBN) 

User Interface Facilities (IRASN)-'- 

Data Management Facilities (IMP)^ 
Standard Data' objects imp. (lARN) 
User Testing (IKSB) 
Training for SDD Tests (B) 
Other packages and Support 
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Notes: 



* _ 



=> As needed. 



1: Current size estimate for Ul S/W is 8K words of Object code => 2K source lines => 
1 person at 2K/MY. Extra help needed during critical early period. 

2: Current size estimate for Data and Storage Management S/W is 16K words of object 
code => 4K source lines => 2 people at 2K./MY. 
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Interdependencies with other departments 

The above described activities depend upon Pilot facilities (especially data management), 
workstation applications specifications and design, and the nature of the 
display/keyboard/pointing device/function keys. The Common Software Group will be 
working closely with the Pilot Group, the Applications Software Group, and the Prototype 
Software Group. 

Issues and Risks 

Workstation applications not specified soon enough. 

Unable to specify a user interface conceptual framework that spans the set of applications. 
Untimely introduction of new user requirements or user devices may cause drastic changes 
in user interface and thus schedule slippage. 




